home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / whois.zip / WHOIS.DOC < prev    next >
Text File  |  1991-06-04  |  6KB  |  163 lines
  1.                 WHOIS - A NetWare User Listing Utility
  2.                           Richard L. Hartman
  3.                              04 June 1991
  4.  
  5.  
  6. Background
  7.  
  8. NetWare imposes limitations on the length and content of usernames.
  9. Many networks use naming conventions which can be somewhat "cryptic",
  10. especially as new users are added.  Furthermore, a multiple-server or
  11. internetworked environment can physically separate users across
  12. parking lots or even geographic boundaries.
  13.  
  14. The NetWare command line utility USERLIST can be used to obtain a list
  15. of users.  However, this list only reports those users currently
  16. logged in to the invoking user's file server, and does not list users
  17. of other servers.
  18.  
  19. Additional information on a user is often available from their "Full
  20. Name".  However, obtaining a full list of all users and their full
  21. names, from all servers, can be a lengthy task - and one which becomes
  22. obsolete quickly as users are added and removed.
  23.  
  24.  
  25.  
  26. The Purpose of WHOIS
  27.  
  28. WHOIS was written to provide a complete list of all users on all file
  29. servers with a single command.
  30.  
  31. WHOIS searches all file servers which are connected or bridged to the
  32. invoking workstation and reports every users' username, full name, and
  33. "home file server".  The list is alphabetized by username for ease of
  34. reference.  Unlike USERLIST, WHOIS reports users whether they are
  35. currently logged in or not.
  36.  
  37.  
  38.  
  39. Using WHOIS
  40.  
  41. WHOIS is very simple to use and requires no command line parameters.
  42. Simply type:
  43.  
  44.      WHOIS   <enter>
  45.  
  46. ...and WHOIS will generate a list of all network users on all file servers
  47. to which it can attach and log in.
  48.  
  49. While not required, WHOIS will accept an optional network username as
  50. a command line argument.  This allows you to obtain information about a
  51. specific user without having to view the entire list.  For example, to
  52. obtain the full name and home server of user CHARLIE, type:
  53.  
  54.      WHOIS CHARLIE   <enter>
  55.  
  56. ...and the information will be shown.
  57.  
  58. WHOIS also supports the use of wildcards in usernames.  The standard
  59. DOS wildcards "*" and "?" may be used to obtain information about
  60. users whose names share common characteristics.  For example, to
  61. obtain a list of all users whose names begin with C, type:
  62.  
  63.      WHOIS C*   <enter>
  64.  
  65. ...and WHOIS will find ALL matching users on ALL servers.
  66.  
  67. Interpretation of wildcards is performed in exactly the same manner as
  68. for DOS filenames: question marks indicate a single unknown character,
  69. while an asterisk indicates zero or more unknown characters.
  70.  
  71. It should be repeated that WHOIS finds ALL matching users on ALL
  72. servers.  This means that like-named users on different servers will
  73. be listed individually, and that like-named accounts for the same
  74. individual on multiple servers will each be listed separately.
  75.  
  76. WHOIS is not case sensitive.  All input is automatically capitalized
  77. prior to use.  The above examples use capitals for clarity.
  78.  
  79.  
  80.  
  81. Redirecting WHOIS Output
  82.  
  83. WHOIS uses standard DOS functions to display characters on the screen.
  84. This was specifically done so that its output could be redirected to a
  85. printer or file using the standard output redirection character ">".
  86. Filters may also be used on WHOIS output in the same manner.  Refer to
  87. your DOS manual for more information on output redirection.
  88.  
  89.  
  90.  
  91. How WHOIS Works
  92.  
  93. WHOIS interacts with the NETx, EMSNETx, and XMSNETx shells to obtain
  94. network services.  It initially confirms that the invoking workstation
  95. is attached and logged in to a NetWare file server.
  96.  
  97. WHOIS then finds a file server on the network and checks if the
  98. workstation is logged in to it.  If not, WHOIS logs in as "GUEST", an
  99. account which is on all NetWare servers by default.  (It can be
  100. deleted, however, and if not found will cause WHOIS to report that it
  101. is having trouble attaching to the server.)
  102.  
  103. Once a connection has been established, WHOIS queries the file server
  104. for information regarding all users that match the command line
  105. parameter. This information is stored internally for later display.
  106.  
  107. WHOIS then handles detachment from the server in the following manner:
  108. If the workstation was already attached to THIS server upon execution,
  109. no action is taken (it is left attached under the same username).  If
  110. it was not attached, WHOIS detaches from the server.  Thus, WHOIS
  111. preserves the entry environment of workstation-server attachments.
  112.  
  113. When all accessible servers have been queried, WHOIS sorts the results
  114. by username and sends them to the screen.  Three columns of data are
  115. presented: The username, the full name, and the server from which the
  116. information was obtained.
  117.  
  118. If Ctrl-Break is used to terminate execution, WHOIS may not have a
  119. chance to log out of remote servers with which it was communicating.
  120. Such connections do not generally represent problems; the NetWare
  121. utility "WHOAMI" may be used to determine if undesired attachments
  122. exist after premature termination of WHOIS.
  123.  
  124. WHOIS interacts with the NetWare shells using documented NetWare
  125. function calls.  No undocumented "tricks" are used anywhere in the
  126. program.
  127.  
  128.  
  129.  
  130. Limitations
  131.  
  132. WHOIS reports all users on all accessible file servers.  This may
  133. include print servers, uninterruptable power supplies, automated
  134. backup systems, and other "peripheral" users that do not necessarily
  135. represent actual people. NetWare does not distinguish between "live"
  136. users and "other" types, and neither does WHOIS; all are reported to
  137. the extent that information is available.
  138.  
  139.  
  140.  
  141. Release to Public Domain
  142.  
  143. As of 04 June 1991, WHOIS.EXE Version 1.4 is released into the public
  144. domain.  The UNALTERED executable file, which is 13903 bytes in size,
  145. may be freely copied and distributed to any interested users as long
  146. as NO FEE IS CHARGED.
  147.  
  148. For ease of use, it is suggested that the network Supervisor place
  149. WHOIS.EXE in the SYS:PUBLIC directory.  However, it will work
  150. regardless of the storage location from which it is invoked.
  151.  
  152. CAUTION:  No tests are performed by WHOIS to insure its own integrity.
  153. As with all downloaded software, unauthorized modification of the code
  154. by persons of ill intent is technically possible.  It is prudent
  155. practice, and the individual responsibility of all users, to confirm
  156. that WHOIS has not been modified to behave in an offensive manner.
  157.  
  158.  
  159.  
  160. Authorship
  161.  
  162. WHOIS was written by Richard L. Hartman (RLH) of Spokane, Washington.
  163.